package com.example.question.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.question.entity.Question;

import java.util.List;

/**
 * 题目服务接口
 * 继承MyBatis-Plus的IService，提供基础的CRUD操作
 * 定义题目相关的业务操作方法
 * @author 颜殿
 */
public interface QuestionService extends IService<Question> {
    /**
     * 基础分页查询
     * @param page 分页参数
     * @return 分页结果
     */
    Page<Question> page(Page<Question> page);

    /**
     * 添加题目
     * 创建一个新的面试题目
     * @param question 题目实体，包含题目的基本信息
     * @return 添加是否成功
     */
    boolean addQuestion(Question question);

    /**
     * 删除题目
     * 根据ID删除指定的题目
     * @param id 要删除的题目ID
     * @return 删除是否成功
     */
    boolean deleteQuestion(Integer id);

    /**
     * 批量删除题目
     * 根据ID列表批量删除多个题目
     * @param ids 要删除的题目ID列表
     * @return 删除是否成功
     */
    boolean batchDeleteQuestions(List<Integer> ids);

    /**
     * 修改题目
     * 更新指定题目的信息
     * @param question 包含更新信息的题目实体
     * @return 更新是否成功
     */
    boolean updateQuestion(Question question);

    /**
     * 根据题目分类分页查询题目
     * 获取指定分类下的题目分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param name 分类ID，可为null表示查询所有分类
     * @return 分页结果，包含题目列表和分页信息
     */
    Page<Question> pageByCategory(Integer pageNum, Integer pageSize, String name);

    /**
     * 根据难度分页查询题目
     * 获取指定难度级别的题目分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param difficulty 难度级别，可为null表示查询所有难度
     * @return 分页结果，包含题目列表和分页信息
     */
    Page<Question> pageByDifficulty(Integer pageNum, Integer pageSize, String difficulty);

    /**
     * 根据状态分页查询题目
     * 获取指定状态的题目分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param status 状态值，可为null表示查询所有状态
     * @return 分页结果，包含题目列表和分页信息
     */
    Page<Question> pageByStatus(Integer pageNum, Integer pageSize, Integer status);

    /**
     * 根据题目描述分页模糊查询题目
     * 获取描述中包含指定关键词的题目分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @param description 关键词，可为null表示查询所有题目
     * @return 分页结果，包含题目列表和分页信息
     */
    Page<Question> pageByDescription(Integer pageNum, Integer pageSize, String description);

    /**
     * 根据题目集ID查询题目
     * 获取指定题目集下的所有题目列表
     * @param setId 题目集ID
     * @return 题目列表
     */
    List<Question> getQuestionsBySetId(Integer setId);

    /**
     * 根据题目集ID获取题目数量
     * @param problemsetId 题目集ID
     * @return 题目数量
     */
    Long countByProblemsetId(Integer problemsetId);
} 